home *** CD-ROM | disk | FTP | other *** search
/ SGI Desktop Special Edition 1.1 / SGI Desktop Special Edition 1.1.iso / relnotes / webspace_author / ch4.z / ch4
Encoding:
Text File  |  1995-11-13  |  21.9 KB  |  595 lines

  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        4.  _K_n_o_w_n__P_r_o_b_l_e_m_s__a_n_d__W_o_r_k_a_r_o_u_n_d_s
  9.  
  10.  
  11.        Here are the known problems in WebSpace Author 1.0, and ways
  12.        to avoid or work around them.
  13.  
  14.        You should also know that there is a complete WebSpace home
  15.        site, which has a page called "What's New".  This site can
  16.        be updated after we release this software to you, so it is a
  17.        good place to look for late-breaking problems and
  18.        workarounds.  The URL is
  19.        http://webspace.sgi.com/WebSpaceAuthor/index.html
  20.  
  21.  
  22.           +o If WebSpace Author is not responding quickly, it may be
  23.             because you have the Outline Viewer.  The Outline
  24.             Viewer can slow down operations in the main window
  25.             because it monitors the scenegraph and might need to
  26.             redraw after each operation, such as a selection, which
  27.             modifies the scenegraph.  If the Outline Viewer is
  28.             slowing you down, close it by double-clicking on the
  29.             "-" sign in the top left of the window border.
  30.  
  31.           +o WebSpace Author saves its files as ASCII Inventor 2.1
  32.             files when you choose "Save" or "Save As..." from the
  33.             File menu.  (Please see the documentation on the
  34.             "Publish..." option if you want to generate strict VRML
  35.             1.0 files.)  Saving as ASCII is inefficient and can
  36.             make file reading and writing slow.  However, WebSpace
  37.             Author is able to read binary WebSpace Author files.
  38.             To convert your WebSpace Author files to binary, type
  39.             this: "ivcat -b myAsciiFile.pronto >
  40.             myBinaryFile.pronto".  You can still double-click on
  41.             the resultant binary file and it will open WebSpace
  42.             Author on that file.
  43.  
  44.           +o Instanced objects are not handled cleanly in all of the
  45.             Editors.  In some instances, the polygon reducer may
  46.             incorrectly remove instanced shapes.  The object
  47.             manipulator (the box-like attachment to the selected
  48.             object) may do strange things to your other instances
  49.             when you manipulate a single instance.  The workaround
  50.             is to copy and paste objects instead of instancing
  51.             them.  You can still NAME the objects (which does a
  52.             "DEF") but you cannot USE them via WSA's graphical
  53.             menus.
  54.  
  55.           +o On Impact and RealityEngine, textured scenes may not
  56.             draw their textures when you change viewers.  This will
  57.             happen if you switch from Walk to Examiner viewer or
  58.             vice versa.  The textures are not lost, they are simply
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.             not drawn.  This is the subject of an OpenGL bug
  75.             TextureObject which will be fixed in a future OpenGL
  76.             implementation.  For now, if you run into this problem,
  77.             you can disable the use of TextureObjects by setting
  78.             the environment variable IV_NO_TEXTURE_OBJECT to 1, and
  79.             restarting the application.  This will cause the
  80.             textures to be drawn correctly, but you may see a drop
  81.             in rendering performance.
  82.  
  83.           +o On systems with XZ and Extreme graphics, textures may
  84.             sometimes appear "ripped".  This problem is most
  85.             noticeable in scenes with two polygons that overlap
  86.             where one polygon is textured and the other is not.  A
  87.             workaround is to add the following node at the top of
  88.             the data file:
  89.  
  90.                 Texture2 {
  91.                    image 1 1 1 0xff
  92.                 }
  93.  
  94.             This assigns a simple texture to every untextured
  95.             object.  This texture does not have any visual effect,
  96.             but it will fix the problem since both polygons are now
  97.             textured.  In many cases, this fix will reduce
  98.             rendering performance.
  99.  
  100.           +o A temporary file may be left in /tmp/.wsa* if you
  101.             preview a file and WSA crashes.  These files are
  102.             removed automatically on reboot. (287771)
  103.  
  104.           +o If you delete all control points in the Shape Modeler,
  105.             it is hard to create new objects.  Choose "New" from
  106.             the Edit menu to start a new object. (290825)
  107.  
  108.           +o The Level Of Detail editor returns to the first level
  109.             when you do a Save from the main window.  There is no
  110.             workaround, but no data is lost. (291210)
  111.  
  112.           +o The Polygon Reducer always reduces objects in local
  113.             coordinates, not global coordinates.  This means that
  114.             objects are decimated based on the size at which they
  115.             were modelled, not the size at which they appear in the
  116.             scene.  Therefore if you take a battleship modelled at
  117.             1:1 scale, and shrink it down to be only 1 meter in
  118.             length, put it in a room, and then polygon reduce
  119.             everything in the room, the battleship may not decimate
  120.             as you would expect.  As a workaround, decimate
  121.             individual objets first and then decimate the room as a
  122.             whole.  (294607)
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.           +o Drawing may be momentarily slow the first time you move
  141.             the scene after importing a new object.  This is
  142.             because Inventor caches drawing information, but
  143.             doesn't build that cache until after it redraws a scene
  144.             a second time.  Once the a redraw are built, the
  145.             interaction and drawing will be as fast as possible.
  146.             To force a redraw without moving anything in the scene,
  147.             simply resize the window, or iconify and deiconify it.
  148.             (296748)
  149.  
  150.           +o The "Optimize Selection..." button on the Tools menu is
  151.             grayed out when a nested nodekit is selected.  You can
  152.             only optimize a top-level nodekit: if you have an
  153.             object selected and cannot Optimize it because the
  154.             Optimizer is grayed out, choose "Select Parent" from
  155.             the Select menu until it becomes available.
  156.  
  157.           +o WebSpaceAuthor cannot read files with textures pointing
  158.             to remote URLs.  You will get a read error if any of
  159.             your textures are stored as links to "http://...."
  160.             style URLs.  As a workaround, copy those textures to
  161.             the local system and link to them as files instead.
  162.             #301871.
  163.  
  164.           +o If you have an object for which backface culling makes
  165.             portions invisible (for instance, a closed room which
  166.             you are looking at from the outside), you can still
  167.             pick the invisible (culled) portions.  This can make
  168.             the snapping tool appear to float in space instead of
  169.             snapping to the visible polygons.  To avoid this, move
  170.             inside the closed object.  #301907.
  171.  
  172.           +o Objects with negative scales may cause strange
  173.             behaviors when they are picked.  Negative scales are
  174.             not recommended.  There is currently no workaround.
  175.             (297089)
  176.  
  177.           +o If the LOD editor stops responding after you choose
  178.             "Make Inline..."  from the LOD editor menu, it is
  179.             because the dialog to name the inline appears in the
  180.             main view instead of the LOD editor.  If the main
  181.             window is not visible, pop up the main window by
  182.             clicking on its title bar. (298816)
  183.  
  184.           +o Home views are not saved when switching viewers: if you
  185.             switch from walk to examiner viewer or to one of the
  186.             Working Views, the Home is set to the viewpoint at
  187.             which you changed viewers.  As a workaround, create a
  188.             named Viewpoint instead of relying on the Go Home
  189.             button in the viewer. (299733)
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.           +o When the LOD editor is set into the "View LOD
  207.             Transitions" mode, the picking of objects is not longer
  208.             allowed.  However, the arrow button stays active, and
  209.             will highlight after being clicked on even though it is
  210.             disabled and objects cannot be picked.  To pick objects
  211.             in the LOD editor, make sure you are not in the "View
  212.             LOD Transitions" mode. (299666)
  213.  
  214.           +o In the Examiner Viewer, it is not possible to move
  215.             beyond the centerpoint of the scene by using the Dolly
  216.             thumbwheel.  (The centerpoint of the scene is the point
  217.             about which the scene rotates.)  To get around this,
  218.             switch to the Walk Viewer by hitting Ctrl-K and
  219.             continue to use the Dolly thumbwheel to get closer.
  220.             (300094)
  221.  
  222.           +o The Text and Shape Modelers do not exit when you exit
  223.             from WebSpace Author.  These are separate programs, so
  224.             you can also launch them multiple times.  You must
  225.             close them separately.  (300041)
  226.  
  227.           +o The Shape Modeler can be slow when the "Shape Style" is
  228.             switched to "Splines".  Use "Face Set" instead.  You
  229.             can switch back and forth between the two modes if you
  230.             want to manipulate the object interactively.  You may
  231.             also want to use the Optimizer and/or the Polygon
  232.             Reducer on the resultant Spline model, since there may
  233.             be an overabundance of polygons in the generated
  234.             surface.  (301745)
  235.  
  236.           +o If you turn on "Show Cull Volumes" from the View menu,
  237.             and you have multiple objects selected, the culling
  238.             volume boxes for the secondary selections will be drawn
  239.             on top of the selection box manipulator.  This results
  240.             in pink/gray color flashing between the two boxes.
  241.             There is no change in the data, and the culling volumes
  242.             and selections are both still accurate.  Either
  243.             deselect the objects you are interested in, or turn off
  244.             "Show Cull Volumes".  (303337)
  245.  
  246.           +o When you edit the text string in the Text Modeler after
  247.             resizing the window or dollying in closer to the text,
  248.             the window may resize and the viewing area may be
  249.             reset.  After adjusting the text string contents,
  250.             resize the window and/or re-dolly closer to the text.
  251.             (304821)
  252.  
  253.           +o The Seek button (the small crosshairs) on the right-
  254.             hand side of the main window does not work when you are
  255.             Viewing mode (the hand).  Switch to Selection mode by
  256.             clicking on the arrow or hitting the ESCape key and try
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.             seeking again.
  273.  
  274.           +o Objects brought into the scene or into the Polygon
  275.             Reducer may be lit darkly.  This may be because the
  276.             surface normals are inverted.  Surface normals for
  277.             objects can be flipped in the Polygon Reduction Editor
  278.             by pushing the "Flip Surface Normals" button.  (306836)
  279.  
  280.           +o When you interactively place an object and you click-
  281.             drag to scale, the scaling may be unintuitive.  This is
  282.             because the centerpoint for the scaling is the midpoint
  283.             of the top left edge of the top surface of the bounding
  284.             box, not the center or the corner of the object.  To
  285.             reposition the object after scaling, use the Snap
  286.             Target in conjunction with the "Move Selection to
  287.             Snapping Target" menu entry. (307778)
  288.  
  289.           +o The Copy button in the Shape Modeler is always enabled,
  290.             even if there is no shape to be copied.  (308391)
  291.  
  292.           +o Some Texture Editor functions may not be undoable.  As
  293.             a workaround, you may want to periodically save your
  294.             data files.  (308716)
  295.  
  296.           +o Scenes which contain anchors which point to nonexistent
  297.             viewpoints in the scene can be read, but the invalid
  298.             anchors are not removed.  To be a conscientious author,
  299.             you should make sure to check that all your links are
  300.             valid.  An easy way to do this is to Publish the file,
  301.             preview it in WebSpace, choose "Show Links" from the
  302.             Options menu, and click on every link in the scene.  A
  303.             more deliberate way is to look at the list of links in
  304.             the Publish dialog, find every link which starts with a
  305.             # (meaning it is a viewpoint), and verify that each of
  306.             those links corresponds to a named Viewpoint in the
  307.             current file.  (309075)
  308.  
  309.           +o It is possible to select an object which has textured
  310.             subparts and have the subpart textures not show up in
  311.             the texture editor window.  Even though this is
  312.             misleading (after all it should show my selection
  313.             unchanged), the texture editor correctly shows the
  314.             result you will get when you press the APPLY button.
  315.             (309513)
  316.  
  317.           +o The "View Selection" function in the View menu can
  318.             sometimes yield total blackness.  Choose "Undo" to get
  319.             back to the previous viewpoint, and move instead of
  320.             selecting "View Selection".  (309331)
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                   - 6 -
  335.  
  336.  
  337.  
  338.           +o If you open the Polygon Reduction tool on an object
  339.             containing Inventor nodekits, you get a dialog
  340.             suggesting you run the 'Optimize Selection' tool on the
  341.             selection to get rid of the nodekits.  If you dismiss
  342.             the dialog and Optimize the selection to remove the
  343.             nodekits, the error dialog comes up a second time.
  344.             This is an artifact of the deselection and reselection
  345.             of the optimized selection.  Please dismiss and ignore
  346.             the second dialog box if the selection appears in the
  347.             Polygon Reduction tool's drawing area.  (309719)
  348.  
  349.           +o If you import an object into WSA, apply a texture to
  350.             it, and save the result out, you get the image field
  351.             AND the filename field written out to the file.  While
  352.             this is somewhat inefficient, it is taken care of in
  353.             the Publish step, when the texture is inlined and JPEG
  354.             compressed automatically.  (309712)
  355.  
  356.           +o The Polygon Reduction editor cannot reduce inlined
  357.             files, and puts up a warning dialog if a selection
  358.             containing an inline is selected.  That warning dialog
  359.             appears over the main window instead of over the
  360.             Polygon Reducer if the Polygon Reducer is not already
  361.             open.  If the main window is not visible, pop up the
  362.             main window by clicking on its title bar.  (309552)
  363.  
  364.           +o Objects not created in the Shape Modeler cannot be
  365.             edited in the Shape Modeler.  They can be imported only
  366.             for placement purposes.  There is no workaround.
  367.             (310397)
  368.  
  369.           +o If you open the Polygon Reducer and then select an
  370.             object which is an Inline you will see an error dialog.
  371.             If you then dismiss the entire Polygon Reducer by
  372.             double-clicking on the top left corner "-" window
  373.             border, the application will be unusable because the
  374.             dialog box has grabbed all the input for the
  375.             application, but it is now gone.  If you do this, then
  376.             double-click on the top left corner "-" window border
  377.             in the main window, and when it asks you to save the
  378.             file, save it.  Reopen WSA and continue editing.
  379.             (310282)
  380.  
  381.           +o The locate-highlighting of the line-edged boxes of the
  382.             Manipulator can be inaccurate: moving the mouse a few
  383.             pixels away from the edge of the wireframe box itself
  384.             can still show it as selected.  Trust the feedback you
  385.             are seeing, even though the cursor may be over a
  386.             different object or face.  If you cannot pick another
  387.             object or surface, try moving closer to the object and
  388.             reselecting.  (303551)
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                   - 7 -
  401.  
  402.  
  403.  
  404.           +o The Make Inline and Set Link tools are disabled if the
  405.             selected object is a node kit, because the code to
  406.             perform these operations dosn't handle them. (It
  407.             assumes the selected object is a Separator.)
  408.  
  409.           +o Textures are fetched asynchronously after the base
  410.             scene has loaded.  This occurs even for local textures.
  411.             There is no workaround except patience.  (309526)
  412.  
  413.           +o When viewing the scene in the Outline Viewer, selection
  414.             is fairly straightforward, with the exception of inline
  415.             and LOD nodes.  If you select the parent of an LOD node
  416.             and open the LOD Editor, no range marks will appear.
  417.             (This is because the node being modified is the Group
  418.             or Separator above it.  Duplicating the level would
  419.             therefore create two children, each of which is an LOD
  420.             node.)
  421.  
  422.             Selection at or under an LOD node is truncated at the
  423.             LOD's parent because only the LOD Editor can modify an
  424.             LOD node.  If the user wishes to modify an existing LOD
  425.             node, they can select the LOD node or below in the
  426.             outline viewer.  Although the selection gets truncated
  427.             to the LOD node's parent in the main window and in the
  428.             Outline Viewer, invoking the LOD Editor will edit the
  429.             first LOD node in the picked path.
  430.  
  431.             Like LOD nodes, Inline nodes should not be modified
  432.             directly.  Thus all selections at or under an inline
  433.             node are stopped at the Group or Separator above the
  434.             Inline.  However, the actual lowest-level object
  435.             selected is stored, and the "Unmake Inline" option on
  436.             the Tools menu will be enabled if the mouse was clicked
  437.             over an Inline node.
  438.  
  439.             A side effect of this is that if you have multiple LODs
  440.             under a single Separator, you cannot pick and
  441.             manipulate the LODs independently of each other.  If
  442.             you need to do this, manually edit the file to add a
  443.             Separator around xeach individual LOD node.  (310364)
  444.  
  445.           +o If you create links to URLs that are directories and
  446.             not files, you may see a warning when the Publish
  447.             dialog checks your URLs.  You can safely ignore that
  448.             warning if you are sure it is valid to link to that
  449.             directory.  A case where this may be valid is when you
  450.             are making a link to a directory containing a file
  451.             called "index.html".  This behavior is discouraged,
  452.             however, because it may not be supported by all
  453.             browsers.  (310564)
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                                   - 8 -
  467.  
  468.  
  469.  
  470.           +o The "Set" button in the Viewpoints editor is not
  471.             undoable.  There is no workaround other than to save
  472.             your file before using the Set button, and then
  473.             performing a "Reopen" from the File menu if you wish to
  474.             get back to the state before the "Set" occurred.
  475.             (310666)
  476.  
  477.           +o It is possible to type illegal characters in the "Make
  478.             Inline..."  dialog box.  Publishing will may create
  479.             invalid files in this case.  You can edit the inline
  480.             name even after typing Make Inline by selecting the
  481.             inlined object again and choosing Make Inline again.
  482.             Please type only characters which are legal UNIX
  483.             filenames into this dialog box.  (309762)
  484.  
  485.           +o If you open the LOD editor on an object which has only
  486.             one level of detail and then use the Appearance editors
  487.             from the LOD editor, it is possible that your changes
  488.             may not be saved in the main scene.  This is because
  489.             the LOD editor caches the selection in order to speed
  490.             its operations.  Do not use the appearance editors in
  491.             the LOD editor to edit objects which are not levels in
  492.             a multi-level LOD node.  (310511)
  493.  
  494.           +o The "Import As URL..." tool on the File menu does not
  495.             allow you to interactively place the imported object.
  496.             Instead, the object is automatically placed in the
  497.             scene.  If you do not see the object appear, then you
  498.             can find it in one of two ways.  Both workarounds
  499.             assume that the object is still selected: the object
  500.             will be selected immediately after import, so be
  501.             careful not to deselect the newly imported object by
  502.             selecting any other object.  One method of finding the
  503.             imported object is to choose "View Selection" from the
  504.             View menu.  Another is to place the Snapping Target
  505.             where you would like the imported object to appear, and
  506.             choose "Move Selection to Snapping Target" from the
  507.             Edit menu.  (309990)
  508.  
  509.           +o Performing redo on LOD nodes which have had levels
  510.             created may dump core if the number of levels have been
  511.             changed from one to two.  The bug only occurs during
  512.             redo, and only after a sequence of selection and
  513.             deselection actions before and after the level
  514.             addition. (310963)
  515.  
  516.           +o When counting triangles in the main window, the
  517.             triangles under the currently rendered LOD will be
  518.             added to the count.  However, the count will not be
  519.             marked dirty if the level changes due to a change in
  520.             view, so attempting a recount will result in the same
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.                                   - 9 -
  533.  
  534.  
  535.  
  536.             number being displayed because the program thinks the
  537.             count is still up to date.  Performing some editing
  538.             action which actuall marks the scene dirty will allow
  539.             the triangles of the new level to be counted. (309183)
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.